home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1997 October: Mac OS SDK / Dev.CD Oct 97 SDK1.toast / Development Kits (Disc 1) / Interfaces&Libraries / Universal / Interfaces / CIncludes / Palettes.h < prev    next >
Encoding:
C/C++ Source or Header  |  1997-08-12  |  6.8 KB  |  246 lines  |  [TEXT/MPS ]
  1. /*
  2.      File:        Palettes.h
  3.  
  4.      Contains:    Palette Manager Interfaces.
  5.  
  6.      Version:    Technology:    System 7.5
  7.                  Release:    Universal Interfaces 3.0.1
  8.  
  9.      Copyright:    © 1987-1993, 1995-1997 by Apple Computer, Inc., all rights reserved
  10.  
  11.      Bugs?:        Please include the the file and version information (from above) with
  12.                  the problem description.  Developers belonging to one of the Apple
  13.                  developer programs can submit bug reports to:
  14.  
  15.                      devsupport@apple.com
  16.  
  17. */
  18. #ifndef __PALETTES__
  19. #define __PALETTES__
  20.  
  21. #ifndef __QUICKDRAW__
  22. #include <Quickdraw.h>
  23. #endif
  24.  
  25.  
  26.  
  27. #if PRAGMA_ONCE
  28. #pragma once
  29. #endif
  30.  
  31. #ifdef __cplusplus
  32. extern "C" {
  33. #endif
  34.  
  35. #if PRAGMA_IMPORT
  36. #pragma import on
  37. #endif
  38.  
  39. #if PRAGMA_STRUCT_ALIGN
  40.     #pragma options align=mac68k
  41. #elif PRAGMA_STRUCT_PACKPUSH
  42.     #pragma pack(push, 2)
  43. #elif PRAGMA_STRUCT_PACK
  44.     #pragma pack(2)
  45. #endif
  46.  
  47.  
  48. enum {
  49.     pmCourteous                    = 0,                            /*Record use of color on each device touched.*/
  50.     pmTolerant                    = 0x0002,                        /*render ciRGB if ciTolerance is exceeded by best match.*/
  51.     pmAnimated                    = 0x0004,                        /*reserve an index on each device touched and render ciRGB.*/
  52.     pmExplicit                    = 0x0008,                        /*no reserve, no render, no record; stuff index into port.*/
  53.     pmWhite                        = 0x0010,
  54.     pmBlack                        = 0x0020,
  55.     pmInhibitG2                    = 0x0100,
  56.     pmInhibitC2                    = 0x0200,
  57.     pmInhibitG4                    = 0x0400,
  58.     pmInhibitC4                    = 0x0800,
  59.     pmInhibitG8                    = 0x1000,
  60.     pmInhibitC8                    = 0x2000,                        /* NSetPalette Update Constants */
  61.     pmNoUpdates                    = 0x8000,                        /*no updates*/
  62.     pmBkUpdates                    = 0xA000,                        /*background updates only*/
  63.     pmFgUpdates                    = 0xC000,                        /*foreground updates only*/
  64.     pmAllUpdates                = 0xE000                        /*all updates*/
  65. };
  66.  
  67. struct ColorInfo {
  68.     RGBColor                         ciRGB;                        /*true RGB values*/
  69.     short                             ciUsage;                    /*color usage*/
  70.     short                             ciTolerance;                /*tolerance value*/
  71.     short                             ciDataFields[3];            /*private fields*/
  72. };
  73. typedef struct ColorInfo ColorInfo;
  74.  
  75. typedef ColorInfo *                        ColorInfoPtr;
  76. typedef ColorInfoPtr *                    ColorInfoHandle;
  77. struct Palette {
  78.     short                             pmEntries;                    /*entries in pmTable*/
  79.     short                             pmDataFields[7];            /*private fields*/
  80.     ColorInfo                         pmInfo[1];
  81. };
  82. typedef struct Palette Palette;
  83.  
  84. typedef Palette *                        PalettePtr;
  85. typedef PalettePtr *                    PaletteHandle;
  86. EXTERN_API( void )
  87. InitPalettes                    (void)                                                        ONEWORDINLINE(0xAA90);
  88.  
  89. EXTERN_API( PaletteHandle )
  90. NewPalette                        (short                     entries,
  91.                                  CTabHandle             srcColors,
  92.                                  short                     srcUsage,
  93.                                  short                     srcTolerance)                        ONEWORDINLINE(0xAA91);
  94.  
  95. EXTERN_API( PaletteHandle )
  96. GetNewPalette                    (short                     PaletteID)                            ONEWORDINLINE(0xAA92);
  97.  
  98. EXTERN_API( void )
  99. DisposePalette                    (PaletteHandle             srcPalette)                            ONEWORDINLINE(0xAA93);
  100.  
  101. EXTERN_API( void )
  102. ActivatePalette                    (WindowPtr                 srcWindow)                            ONEWORDINLINE(0xAA94);
  103.  
  104. EXTERN_API( void )
  105. SetPalette                        (WindowPtr                 dstWindow,
  106.                                  PaletteHandle             srcPalette,
  107.                                  Boolean                 cUpdates)                            ONEWORDINLINE(0xAA95);
  108.  
  109. EXTERN_API( void )
  110. NSetPalette                        (WindowPtr                 dstWindow,
  111.                                  PaletteHandle             srcPalette,
  112.                                  short                     nCUpdates)                            ONEWORDINLINE(0xAA95);
  113.  
  114. EXTERN_API( PaletteHandle )
  115. GetPalette                        (WindowPtr                 srcWindow)                            ONEWORDINLINE(0xAA96);
  116.  
  117. EXTERN_API( void )
  118. CopyPalette                        (PaletteHandle             srcPalette,
  119.                                  PaletteHandle             dstPalette,
  120.                                  short                     srcEntry,
  121.                                  short                     dstEntry,
  122.                                  short                     dstLength)                            ONEWORDINLINE(0xAAA1);
  123.  
  124. EXTERN_API( void )
  125. PmForeColor                        (short                     dstEntry)                            ONEWORDINLINE(0xAA97);
  126.  
  127. EXTERN_API( void )
  128. PmBackColor                        (short                     dstEntry)                            ONEWORDINLINE(0xAA98);
  129.  
  130. EXTERN_API( void )
  131. AnimateEntry                    (WindowPtr                 dstWindow,
  132.                                  short                     dstEntry,
  133.                                  const RGBColor *        srcRGB)                                ONEWORDINLINE(0xAA99);
  134.  
  135. EXTERN_API( void )
  136. AnimatePalette                    (WindowPtr                 dstWindow,
  137.                                  CTabHandle             srcCTab,
  138.                                  short                     srcIndex,
  139.                                  short                     dstEntry,
  140.                                  short                     dstLength)                            ONEWORDINLINE(0xAA9A);
  141.  
  142. EXTERN_API( void )
  143. GetEntryColor                    (PaletteHandle             srcPalette,
  144.                                  short                     srcEntry,
  145.                                  RGBColor *                dstRGB)                                ONEWORDINLINE(0xAA9B);
  146.  
  147. EXTERN_API( void )
  148. SetEntryColor                    (PaletteHandle             dstPalette,
  149.                                  short                     dstEntry,
  150.                                  const RGBColor *        srcRGB)                                ONEWORDINLINE(0xAA9C);
  151.  
  152. EXTERN_API( void )
  153. GetEntryUsage                    (PaletteHandle             srcPalette,
  154.                                  short                     srcEntry,
  155.                                  short *                dstUsage,
  156.                                  short *                dstTolerance)                        ONEWORDINLINE(0xAA9D);
  157.  
  158. EXTERN_API( void )
  159. SetEntryUsage                    (PaletteHandle             dstPalette,
  160.                                  short                     dstEntry,
  161.                                  short                     srcUsage,
  162.                                  short                     srcTolerance)                        ONEWORDINLINE(0xAA9E);
  163.  
  164. EXTERN_API( void )
  165. CTab2Palette                    (CTabHandle             srcCTab,
  166.                                  PaletteHandle             dstPalette,
  167.                                  short                     srcUsage,
  168.                                  short                     srcTolerance)                        ONEWORDINLINE(0xAA9F);
  169.  
  170. EXTERN_API( void )
  171. Palette2CTab                    (PaletteHandle             srcPalette,
  172.                                  CTabHandle             dstCTab)                            ONEWORDINLINE(0xAAA0);
  173.  
  174. EXTERN_API( long )
  175. Entry2Index                        (short                     entry)                                TWOWORDINLINE(0x7000, 0xAAA2);
  176.  
  177. EXTERN_API( void )
  178. RestoreDeviceClut                (GDHandle                 gd)                                    TWOWORDINLINE(0x7002, 0xAAA2);
  179.  
  180. EXTERN_API( void )
  181. ResizePalette                    (PaletteHandle             p,
  182.                                  short                     size)                                TWOWORDINLINE(0x7003, 0xAAA2);
  183.  
  184. EXTERN_API( void )
  185. SaveFore                        (ColorSpec *            c)                                    THREEWORDINLINE(0x303C, 0x040D, 0xAAA2);
  186.  
  187. EXTERN_API( void )
  188. SaveBack                        (ColorSpec *            c)                                    THREEWORDINLINE(0x303C, 0x040E, 0xAAA2);
  189.  
  190. EXTERN_API( void )
  191. RestoreFore                        (const ColorSpec *        c)                                    THREEWORDINLINE(0x303C, 0x040F, 0xAAA2);
  192.  
  193. EXTERN_API( void )
  194. RestoreBack                        (const ColorSpec *        c)                                    THREEWORDINLINE(0x303C, 0x0410, 0xAAA2);
  195.  
  196. EXTERN_API( OSErr )
  197. SetDepth                        (GDHandle                 gd,
  198.                                  short                     depth,
  199.                                  short                     whichFlags,
  200.                                  short                     flags)                                THREEWORDINLINE(0x303C, 0x0A13, 0xAAA2);
  201.  
  202. EXTERN_API( short )
  203. HasDepth                        (GDHandle                 gd,
  204.                                  short                     depth,
  205.                                  short                     whichFlags,
  206.                                  short                     flags)                                THREEWORDINLINE(0x303C, 0x0A14, 0xAAA2);
  207.  
  208. EXTERN_API( short )
  209. PMgrVersion                        (void)                                                        TWOWORDINLINE(0x7015, 0xAAA2);
  210.  
  211. EXTERN_API( void )
  212. SetPaletteUpdates                (PaletteHandle             p,
  213.                                  short                     updates)                            THREEWORDINLINE(0x303C, 0x0616, 0xAAA2);
  214.  
  215. EXTERN_API( short )
  216. GetPaletteUpdates                (PaletteHandle             p)                                    THREEWORDINLINE(0x303C, 0x0417, 0xAAA2);
  217.  
  218. EXTERN_API( Boolean )
  219. GetGray                            (GDHandle                 device,
  220.                                  const RGBColor *        backGround,
  221.                                  RGBColor *                foreGround)                            THREEWORDINLINE(0x303C, 0x0C19, 0xAAA2);
  222.  
  223.  
  224.  
  225.  
  226. #if PRAGMA_STRUCT_ALIGN
  227.     #pragma options align=reset
  228. #elif PRAGMA_STRUCT_PACKPUSH
  229.     #pragma pack(pop)
  230. #elif PRAGMA_STRUCT_PACK
  231.     #pragma pack()
  232. #endif
  233.  
  234. #ifdef PRAGMA_IMPORT_OFF
  235. #pragma import off
  236. #elif PRAGMA_IMPORT
  237. #pragma import reset
  238. #endif
  239.  
  240. #ifdef __cplusplus
  241. }
  242. #endif
  243.  
  244. #endif /* __PALETTES__ */
  245.  
  246.